home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / misc / vrx110.zip / TECHNOTE.TXT < prev    next >
Text File  |  1994-01-24  |  6KB  |  198 lines
  1. TECHNICAL DETAILS ON VRXPLORER v. 1.1
  2. -------------------------------------
  3.  
  4. It is important to know how VRXplorer works to get 
  5. better results from its use.
  6.  
  7.  
  8. Preparing the images
  9. --------------------
  10.  
  11. To create your own views it is necessary to have the 
  12. availability of a VCR and a video capture board connected 
  13. to your computer. In this way you can create the necessary 
  14. .BMP images that will be used in your views.
  15.  
  16. We suggest to adopt a standard format for your file names. 
  17. Let's examine this example:
  18.  
  19. i.e. EXAMPNE0.BMP is composed by
  20.  
  21. - a first part of free text (up to you) i.e. "EXAMP";
  22. - the last 3 (or 4) chars that indicate the direction of 
  23.   the shooted image (i.e. "North East") and the view height 
  24.   ("0" is straight view, "1" means raised by one unit, 
  25.   "-1" lowered by one unit, and so on).
  26.  
  27. Direction unit in the enclosed examples is 45 degree 
  28. ( 45 x 8 directions = 360 degree). The height is up to you.
  29.  
  30. The more accurate is the capture process and the better result 
  31. you will have.
  32.  
  33.  
  34.  
  35. Creating a new view with VRX Author
  36. -----------------------------------
  37.  
  38. When you want to create a new 360 degree view, you need to choose
  39. first your working directory.
  40. The default path is "./VRX_VIEW" where the dot means the current 
  41. directory where VRX Author is running.
  42.  
  43. When you choose your working directory, VRX Author attempts to 
  44. change to it or creates it as a new one. 
  45. This directory is going to collect your .BMP files togheter 
  46. with the relative .VRX files (these are text files that contain 
  47. the links of that image to the other ones).
  48.  
  49. The working directory collects your images in a unique destination, 
  50. copying them from the desired sources.
  51.  
  52. Select now NEW VIEW from the File menu. This reset completely the 
  53. stage array (view). Unlike NEW VIEW, the CLEAR SCREEN command 
  54. doesn't reset completely the stage array. This make it suitable 
  55. to be used during the editing process.
  56.  
  57.  
  58.  
  59.  
  60. Editing a view with VRX Author
  61. ------------------------------
  62.  
  63. From the file list, drag and drop the images you need and 
  64. compose your view. The process might be slow if you don't have 
  65. a fast CPU, as VRX Author updates each time the image 
  66. links (references) on disk.
  67.  
  68. Once inserted in the view, an image can be moved in an other 
  69. stage or deleted, too. You can not display the same image 
  70. twice in the stage array.
  71.  
  72. When you drag and drop and image in the trash can, 
  73. you delete its .VRX file from disk. If you have previsouly used 
  74. this image, remember to estabilish again the lost links 
  75. (feature to be improved in next releases).
  76.  
  77.  
  78.  
  79. Scrolling a view with VRX Author
  80. --------------------------------
  81.  
  82. You can scroll the view to add new images. VRX Author is able 
  83. to recover from disk the images scrolled outside the current view.
  84.  
  85. Each image must have at least one link to be scrolled outside 
  86. the view. VRX Author does not allow to scroll all images outside 
  87. the view, so that the stage array remains empty.
  88.  
  89.  
  90.  
  91.  
  92. Creating a 360 degree view with VRX Author
  93. ------------------------------------------
  94.  
  95. To close an open view so that it can be shown as a 360 degree view, 
  96. you have to join its external borders loading again the image that 
  97. is on the opposite side.
  98.  
  99. Remember that each time VRX Author finds that a file has already 
  100. been used, it merges the new links to the existing ones.
  101.  
  102.  
  103.  
  104. Loading a view from disk with VRX Author
  105. ----------------------------------------
  106.  
  107. If you want to check the links of a previously edited view, 
  108. switch to OPEN VRX FILES and drag and drop the .VRX file in 
  109. the central stage.
  110.  
  111. If you want to load a view that is contained in a different 
  112. directory, remember first to set your working directory to the new one. 
  113.  
  114. If you have just launched VRX Author from disk, check that your 
  115. working directory is the same of the one where you have stored 
  116. the views you want to load now.
  117.  
  118.  
  119.  
  120. Saving a view on disk with VRX Author
  121. -------------------------------------
  122.  
  123. There is no need to save manually a view on disk. 
  124. This operation is made automatically by VRX Author each time 
  125. an image is inserted, moved or deleted from the view.
  126.  
  127.  
  128.  
  129. Assigning a caption to the images with VRX Author
  130. -------------------------------------------------
  131.  
  132. Each image can have a caption of max 50 chars. Double click on the 
  133. stage which contains the image you want to assign a caption 
  134. and fill the dialog box.
  135.  
  136.  
  137.  
  138. Playing a view with VRX Author
  139. ------------------------------
  140.  
  141. To play a view you need to specify a starting image. Double click 
  142. on the stage which contains the image you want to specify as 
  143. starting and check the proper button.
  144. Choose then PLAY VIEW from the menubar.
  145.  
  146. Your view will be displayed by a new application called VRX Player, 
  147. that is instructed by the VRX Author through DDE protocol.
  148.  
  149. To scroll the view, move the mouse along the borders of the image.
  150. When the cursor changes shape, click the mouse. 
  151. If you keep pressed the mouse button, you scroll the view continuously.
  152.  
  153.  
  154.  
  155. Using VRX views in your own software
  156. ------------------------------------
  157.  
  158. You can use VRX views in your applications.
  159.  
  160. The first step is to get the password to access to VRX Player scripts 
  161. (please read the Introduction page in VRX Author and the 
  162. file LICENCE.TXT, too).
  163.  
  164. Then you have to include the VRX Player elements in your 
  165. software, that is:
  166.  
  167. the group "VRXPlayer"
  168. the field "ClipText"
  169.  
  170. When you copy and paste these objects in your application, 
  171. remember to import the 8 direction cursor shapes in your new book, too. 
  172. You can do this procedure calling the handler "ImportVRXCursors" 
  173. contained in the group "VRXPlayer", keeping your book and the cursor 
  174. files in the same directory.
  175.  
  176. There are two basic handlers that control the virtual views:
  177.  
  178. playView    contained in stage "VRXPlayer"    and
  179. resetVRXPlayer     contained in stage "VRXPlayer"
  180.  
  181. Details on their use are contained in the script self.
  182. The same password used to unlock VRX Player scripts can be used 
  183. to access to the scripts of the "Virtual Venice" demo.
  184.  
  185.  
  186. --------------
  187.  
  188.  
  189. Should you find difficulties in implementing VRX views in your software,
  190. please write to the author.
  191. Proposal of collaboration in the field of multimedia towards Internet are
  192. welcome.
  193.  
  194.  
  195. Paolo Tosolini
  196. tosolini@psicosun.univ.trieste.it
  197. http://www.univ.trieste.it/tosolini.html
  198.